home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / filter.1 < prev    next >
Text File  |  1995-07-25  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4.      FFFFIIIILLLLTTTTEEEERRRR((((1111LLLL))))  UUUUSSSSEEEENNNNEEEETTTT CCCCoooommmmmmmmuuuunnnniiiittttyyyy TTTTrrrruuuusssstttt ((((EEEEllllmmmm VVVVeeeerrrrssssiiiioooonnnn 2222....4444))))   FFFFIIIILLLLTTTTEEEERRRR((((1111LLLL))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           filter - filter incoming messages before adding to mailbox
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ffffiiiilllltttteeeerrrr [-q] [-v] [-l] [-o output] [-f rules-file]
  13.           ffffiiiilllltttteeeerrrr [-n] [-f rules-file]
  14.           ffffiiiilllltttteeeerrrr [-r] [-o output] [-f rules-file]
  15.           ffffiiiilllltttteeeerrrr [-c] [-s] [-o output] [-f rules-file]
  16.           ffffiiiilllltttteeeerrrr [-c] [-S] [-o output] [-f rules-file]
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.           _F_i_l_t_e_r uses a set of selection rules to process incoming
  20.           mail messages.  The format for the rules, located in
  21.           $HOME/.elm/filter-rules, is;
  22.  
  23.                   _r_u_l_e  ::=  iiiiffff  ((((_e_x_p_r_e_s_s_i_o_n))))  tttthhhheeeennnn  _a_c_t_i_o_n
  24.  
  25.           where _e_x_p_r_e_s_s_i_o_n is:
  26.  
  27.                   _e_x_p_r_e_s_s_i_o_n  ::=  {  nnnnooootttt  }  _c_o_n_d_i_t_i_o_n  _e_x_p_r_2
  28.  
  29.                   _e_x_p_r_2  ::=  _N_U_L_L  |  aaaannnndddd  _c_o_n_d_i_t_i_o_n  _e_x_p_r_2
  30.  
  31.                   _c_o_n_d_i_t_i_o_n  ::=  _f_i_e_l_d  _r_e_l_a_t_i_o_n_s_h_i_p  _v_a_l_u_e
  32.                              ::=  lllliiiinnnneeeessss  _r_e_l_o_p  _n_u_m_v_a_l_u_e
  33.           or                 ::=  aaaallllwwwwaaaayyyyssss
  34.  
  35.           These further break down as:
  36.  
  37.                   _f_i_e_l_d  ::=  ffffrrrroooommmm  |  ssssuuuubbbbjjjjeeeecccctttt  |  ttttoooo  |  lllliiiinnnneeeessss | sssseeeennnnddddeeeerrrr
  38.  
  39.                   _r_e_l_a_t_i_o_n_s_h_i_p  ::=  ====  |  !!!!====
  40.  
  41.                   _r_e_l_o_p  ::=  ====  |  !!!!====  |  <<<<  |  >>>>  |  <<<<====  |  >>>>====
  42.  
  43.                   _v_a_l_u_e  ::=  _a_n_y  _q_u_o_t_e_d  _s_t_r_i_n_g
  44.  
  45.                   _n_u_m_v_a_l_u_e  ::=  _a_n_y  _i_n_t_e_g_e_r  _v_a_l_u_e
  46.  
  47.           _A_c_t_i_o_n can be any of:
  48.  
  49.                   ddddeeeelllleeeetttteeee
  50.                   ssssaaaavvvveeee  _f_o_l_d_e_r_n_a_m_e
  51.                   ssssaaaavvvveeeeccccooooppppyyyy _f_o_l_d_e_r_n_a_m_e
  52.                   eeeexxxxeeeeccccuuuutttteeee  _c_o_m_m_a_n_d
  53.                   eeeexxxxeeeeccccuuuutttteeeecccc  _c_o_m_m_a_n_d
  54.                   ffffoooorrrrwwwwaaaarrrrdddd  _a_d_d_r_e_s_s
  55.                   lllleeeeaaaavvvveeee
  56.  
  57.           For further information about the rules language, please see
  58.           _T_h_e _E_l_m _F_i_l_t_e_r _G_u_i_d_e.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/15/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      FFFFIIIILLLLTTTTEEEERRRR((((1111LLLL))))  UUUUSSSSEEEENNNNEEEETTTT CCCCoooommmmmmmmuuuunnnniiiittttyyyy TTTTrrrruuuusssstttt ((((EEEEllllmmmm VVVVeeeerrrrssssiiiioooonnnn 2222....4444))))   FFFFIIIILLLLTTTTEEEERRRR((((1111LLLL))))
  71.  
  72.  
  73.  
  74.           The flags the _f_i_l_t_e_r program understands are;
  75.  
  76.           ----cccc        Clear logs.  If this flag is used, the log files
  77.                     will be removed after being summarized by either
  78.                     "-s" or "-S" (see below).
  79.  
  80.           ----ffff _r_u_l_e_s-_f_i_l_e
  81.                     Get rules from specified file instead of default
  82.                     $HOME/.elm/filter-rules
  83.  
  84.           ----llll        Log actions only.  Do not log information about
  85.                     mailed messages.
  86.  
  87.           ----nnnn        Not really.  Output what would happen if given
  88.                     message from standard input, but don't actually do
  89.                     anything with it.
  90.  
  91.           ----oooo _f_i_l_e   Redirect stdout messages to the specified file or
  92.                     device.  Logging of filter actions is not
  93.                     affected.  (This is added to more gracefully deal
  94.                     with changes in the file system (since sendmail is
  95.                     quite picky about modes of files being redirected
  96.                     into.))
  97.  
  98.           ----qqqq        Quiet.  Do not log filtering actions.
  99.  
  100.           ----rrrr        Rules.  List the rules currently being used.
  101.  
  102.           ----ssss        Summarize.  List a summary of the message
  103.                     filtering log.
  104.  
  105.           ----SSSS        This is the same as `-s' but includes message-by-
  106.                     message information additionally.
  107.  
  108.           ----vvvv        Verbose.  Give output on standard out for each
  109.                     message filtered.  Useful to have redirected to
  110.                     ``/dev/console'' and such.  (see ----oooo too).
  111.  
  112.      AAAAUUUUTTTTHHHHOOOORRRR
  113.           Elm Development Group
  114.  
  115.      FFFFIIIILLLLEEEESSSS
  116.           $HOME/.elm/filter-rules     Default rules file
  117.           $HOME/.elm/filterlog        A log of what has been done
  118.           $HOME/.elm/filtersum        A summary of what has been done
  119.           /etc/passwd             Used to get users home directory
  120.  
  121.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  122.           _T_h_e _E_l_m _F_i_l_t_e_r _G_u_i_d_e
  123.           readmsg(1L), elm(1L), mail(1), mailx(1), sendmail(1,8)
  124.  
  125.      CCCCOOOOMMMMMMMMEEEENNNNTTTTSSSS
  126.  
  127.  
  128.  
  129.      PPPPaaaaggggeeee 2222                                          ((((pppprrrriiiinnnntttteeeedddd 7777////11115555////99995555))))
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      FFFFIIIILLLLTTTTEEEERRRR((((1111LLLL))))  UUUUSSSSEEEENNNNEEEETTTT CCCCoooommmmmmmmuuuunnnniiiittttyyyy TTTTrrrruuuusssstttt ((((EEEEllllmmmm VVVVeeeerrrrssssiiiioooonnnn 2222....4444))))   FFFFIIIILLLLTTTTEEEERRRR((((1111LLLL))))
  137.  
  138.  
  139.  
  140.           Not really smart about pattern matching.
  141.  
  142.      BBBBUUUUGGGG RRRREEEEPPPPOOOORRRRTTTTSSSS TTTTOOOO
  143.           Syd Weinstein  elm@DSI.COM    (dsinc!elm)
  144.  
  145.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTTSSSS
  146.           Copyright 1988-1992 by The USENET Community Trust
  147.           Derived from Elm 2.0,  Copyright 1986, 1987 by Dave Taylor
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 7/15/95)
  196.  
  197.  
  198.  
  199.